Summary

This PR adds events compatible with lordsimal/cakephp-sentry for queue monitoring and tracing, as proposed in LordSimal/cakephp-sentry#43.

Instead of including Sentry-specific code directly in the queue plugin (as in #449), this approach dispatches generic events that the Sentry plugin can listen to:

• CakeSentry.Queue.enqueue: Fired when a job is added to the queue (producer side)
• CakeSentry.Queue.beforeExecute: Fired when a worker begins processing a job (consumer side)
• CakeSentry.Queue.afterExecute: Fired when a job finishes (success or failure)

This enables integration with Sentry's queue monitoring without requiring the queue plugin to depend on the Sentry SDK.

Trace Propagation

For distributed tracing, users can add Sentry trace headers to job data when creating jobs:

$data = ['your_data' => 'here'];

if (class_exists(\Sentry\SentrySdk::class)) {
    $data['_sentry_trace'] = \Sentry\getTraceparent();
    $data['_sentry_baggage'] = \Sentry\getBaggage();
}

$queuedJobsTable->createJob('MyTask', $data);

The queue plugin will pass these headers to the beforeExecute event for trace continuation.

Related Issues

• Missing Sentry features LordSimal/cakephp-sentry#17
• Supersedes Add queue job lifecycle events for monitoring integration #449

Test plan

• Added test for CakeSentry.Queue.enqueue event
• Added test for CakeSentry.Queue.beforeExecute event
• Added test for CakeSentry.Queue.afterExecute success event
• Added test for CakeSentry.Queue.afterExecute failure event
• All 131 tests pass
• Documentation updated in docs/sections/misc.md